sequenceDiagram
    participant Client
    participant SubmissionHandler as Submit Handler
    participant Provider as Stellar Provider
    participant Decoder as XDR Decoder
    participant Metrics as Metrics Registry

    Client->>SubmissionHandler: Submit transaction
    SubmissionHandler->>Provider: Call submit_transaction
    
    alt Provider Error
        Provider-->>SubmissionHandler: Error response
        SubmissionHandler->>Metrics: Increment STELLAR_SUBMISSION_FAILURES<br/>[provider_error]
        SubmissionHandler-->>Client: TransactionError
    else TRY_AGAIN_LATER
        Provider-->>SubmissionHandler: TRY_AGAIN_LATER status
        SubmissionHandler->>Metrics: Increment STELLAR_SUBMISSION_FAILURES<br/>[try_again_later, n/a]
        SubmissionHandler-->>Client: Failure result
    else ERROR with XDR
        Provider-->>SubmissionHandler: ERROR + error_result_xdr
        SubmissionHandler->>Decoder: decode_tx_result_code(xdr)
        Decoder-->>SubmissionHandler: result_code (e.g., "TxBadSeq")
        SubmissionHandler->>Metrics: Increment STELLAR_SUBMISSION_FAILURES<br/>[error, result_code]
        SubmissionHandler-->>Client: Detailed error with code
    else Unknown Status
        Provider-->>SubmissionHandler: Unknown status
        SubmissionHandler->>Metrics: Increment STELLAR_SUBMISSION_FAILURES<br/>[unknown_status, n/a]
        SubmissionHandler-->>Client: Unknown error
    end